Documentation and the users of digital resources in the humanities

Purpose This article discusses the importance of documentation for digital humanities resources. This includes technical documentation of textual markup or database construction, and procedural documentation about resource construction. Methodology We present a case study of an attempt to re-use electronic text to create a digital library for humanities users, as part of the UCIS project. We discuss the results of qualitative research by the LAIRAH study on provision of procedural documentation, and user perception of the purpose, construction and usability of resources collected using semi-structured interviews and user workshops. Findings In the absence of technical documentation, it was impossible to reuse text files with inconsistent markup (COCOA and XML) in a Digital Library. Also, although users require procedural documentation, about the status and completeness of sources, and selection methods, this is often difficult to locate. Practical implications Creators of digital humanities resources should provide both technical and procedural documentation and make it easy to find, ideally from the project website. To ensure that documentation is provided, research councils could make documentation a project deliverable. This will be even more vital once the AHDS is no longer funded to help ensure good practice in digital resource creation